home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / dskutil / honto211.zip / HONTO.DOC < prev    next >
Text File  |  1995-01-06  |  10KB  |  210 lines
  1. Honto v2.11                                                           01/08/95
  2. (c) 1993,95 Sam Leventer
  3.  
  4. Description
  5. ~~~~~~~~~~~
  6.   Honto is a program that helps you identify an unknown filetype.  Its name
  7. comes from the Japanese word meaning really, or truely.  This is because
  8. Honto is not mislead by an incorrect extension; It tells you what a file
  9. really is.  Honto colors a file's listing, depending on its type, tells you
  10. what type of file it is, and optionally displays extra information.  Honto can
  11. also sort the list of files in several different ways.  The included
  12. configuration program allows you to customize Honto.  It also performs a CRC
  13. check on Honto, to detect virus infection.
  14.  
  15.   One situation where you might need a program like this is if you have a
  16. large number of backup files, all with the extension .BAK, some created with
  17. PKLite, some with GIFLite, others backups from your paint program, other
  18. backups from your word processor, etc... and you need to restore these
  19. backups.  Rather than going through a trial and error process in each program,
  20. you can simply type HONTO *.BAK, and find out what each file is.  Or, if a
  21. file comes with several WHATEVER.000, WHATEVER.001, etc. files, and you are
  22. curious as to what type of files those are, simply type HONTO *.0*.
  23.  
  24.   Honto is also usefull in identifying self-extracting archives, created by
  25. all of the major archive software.  When you recieve a (supposed) self-
  26. extracting file, use Honto to be sure that it is not a "trojan horse" type
  27. program.
  28.  
  29.   Another usage of Honto would be as replacement for the DIR command.  Honto
  30. is designed to work identical to the DIR command, except for including extra
  31. information on the right side of the screen, and coloring files depending on
  32. their filetype.  With version 2.0, Honto now can sort in a manner almost
  33. identical to the way DIR does.  Also, you may specify more than one wildcard
  34. on the command line.  DIR is restricted to displaying one filespec at a
  35. time.  Honto can show all of your .GIF and .EXE files in one listing.
  36.   Combining those two features is one of Honto's most powerful features.
  37. There is no way at all, using plain DOS, to produce a sorted list of
  38. different file-types.  For example, say that you want a list of all your
  39. graphic images, sorted by size.  With Honto, you simply type the following:
  40. HONTO C:\GRAPHICS\*.GIF *.PCX *.BMP /OS
  41. Adding /M would add information on the image sizes and colors.
  42.  
  43.   Honto can be used to compare the efficiency of different graphics formats.
  44. For each graphics file, Honto displays a "compression ratio."  The higher
  45. this number is, the more the image has been compressed.  GIF images typically
  46. have compression ratios of 50% to 60%, while JPEG images have ratios of
  47. 80%-90%.
  48.  
  49.   If a file has an extension that Honto recognizes as not matching the
  50. standard extension for that filetype, such as if a ZIP file has been renamed
  51. to .QWK, then the file's current extension will be displayed in lower case.
  52. This will draw your attention to files with incorrect extensions.  The correct
  53. file description will still appear beside the directory listing.
  54.  
  55.   Honto displays files in different colors depending on the type of file that
  56. it is.  The following chart shows the default colors:
  57.  
  58.                         Archives....... Bright Blue
  59.                         Programming.... Dark Blue
  60.                         Pictures....... Red
  61.                         Sound.......... Magenta
  62.                         Executables.... White
  63.                         Text........... Gray
  64.                         Directories.... Dark Gray
  65.                         Unknown files.. Gray
  66.  
  67.   This grouping was done so that you could easily pick out related files.
  68. Using the included HONTOCFG.EXE utility, you may easily change the default
  69. coloring to any colors that you wish.  However, the grouping may not be
  70. changed (ie GIF and PCX images must be the same color).
  71.  
  72.  
  73. Command line switches
  74. ~~~~~~~~~~~~~~~~~~~~~
  75.   If you specify /E, for extra, then (with certain types of files), Honto will
  76. give you extra information.  The chart below shows which filetypes contain
  77. extra information.  I tried to come to a reasonable trade-off between amount
  78. of information and time to retrieve it.
  79.   Based on a user suggestion, I have implemented a switch /M, that displays
  80. a medium amount of information.  The extra information switch will display
  81. a large amount of facts about your files, but you may not want that.  /M will
  82. just display whatever information will fit in the right side of the screen.
  83. This switch will probably prove to be the most used switch for most users.
  84.   Normally, direct screen writes are used, for color support.  However, if you
  85. need to re-direct the output, direct screen writes will not work.  To solve
  86. this problem, use /B, for Black and white output. If you have speech software,
  87. or other specialty software that needs to trap information being written to
  88. the screen, it will be able to trap output when /B is used.
  89.   Specifying /P will pause the screen every time it fills up.  This way you
  90. can easily view large directories, without keeping your finger on the pause
  91. key.
  92.   The sort switch, /O is different in that it must be followed by another
  93. letter (N,S,D,E or G) depending on what type of sort you want.  Those
  94. letters will, respectively, give a listing sorted by filename (A to Z), size
  95. (ascending), date (ascending), extension (A-Z) or with directories clumped
  96. in front.
  97.   Command line switches must be preceded by a '/' or '-', without the quotes.
  98. One slash (or dash) will cover all command line options until a space.  Also,
  99. options and filenames may be interleaved in any order.
  100.   The following are all CORRECT uses of Honto:
  101.  
  102. HONTO C:\SCANS\*.PCX /EB > PICTURES.TXT ; Will make a file containing a list
  103.                                           of all PCX files in the C:\SCANS
  104.                                           directory, with extra info.
  105. HONTO D:\DOWNLOAD\*.* -E -B             ; Lists all files in the download
  106.                                           directory, with extra info, in B&W.
  107. HONTO                                   ; Shows a colored list of current dir.
  108. HONTO ..\*.0* -p /E
  109. HONTO *.PCX *.GIF *.BMP /M /OS          ; Shows all pictures, with dimensions,
  110.                                           sorted by size.
  111. HONTO *.txt /pod                        ; Shows a colored list, sorted by date,
  112.                                           pausing every screenfull,
  113. Notes
  114. ~~~~~
  115.   Note: For some file types, there is no reliable way to identify files.  This
  116. shows nothing but a lack of foresight by the designer of the file format.  For
  117. example, Amiga modules (music files) have no ID information whatsoever.  There
  118. is no quick way to identify the file as a .MOD, and I felt that speed was more
  119. important than searching the file for correct sample information.  For some
  120. other file types, notably .COM files, the detection is not too reliable.  In
  121. general, if Honto says "probably", it means just that.
  122.  
  123.   When specifying several wildcards, only the first one may conatain path
  124. information.  This means that Honto cannot combine listings from several
  125. directories into one.
  126.  
  127.   For image files, in the extra information, Honto displays a "compression
  128. ratio."  This is a measure of how much the file compressed by the format.
  129. A higher compression ratio means that the file was more compressible
  130. (smaller).
  131.  
  132.   When sorting files, Honto does not (right now, at least) support
  133. reversing the search with a hyphen.
  134.  
  135. Registration
  136. ~~~~~~~~~~~~
  137.   This is a release version of Honto, and registration is REQUIRED!  That
  138. means that you MUST pay for Honto.  The fee for using Honto is a mere $20.
  139. For that price, you recieve the legal right to use Honto beyond a 10 day
  140. evaluation period, and notification of new versions.  For $25, you will be
  141. mailed the next new version of Honto, when released.  Please register, as many
  142. hours of hard work have gone into this program.  Also, I am very willing to
  143. implement suggestions, if you let me know of them.
  144.  
  145. Copyrights
  146. ~~~~~~~~~~
  147.   All program code and data, including this Documentation file, are
  148. copyrighted 1995 by Sam Leventer.
  149.  
  150.   ARJ is copyright R.K. Jung.
  151.   Doom is (c) ID software.
  152.   GIF is a trademark of Compu$erve, an H&R Block company.
  153.   PC Paintbrush is a trademark of Z-Soft, Inc.
  154.   PKZip is a trademark of PKWare.
  155.   Turbo Pascal is a trademark of Borland International.
  156.   Windows is a trademark of Microsoft Corp.
  157.   Word Perfect is a trademark of the Word Perfect Corp.
  158.   All other trademarks and copyrights are property of their owners.
  159.  
  160.  
  161. Contacting Me
  162. ~~~~~~~~~~~~~
  163. Snail mail:
  164.   Sam Leventer
  165.   106 West Ave
  166.   Ithaca, NY 14850
  167.  
  168. E-Mail:
  169.    Internet- sl63@cornell.edu
  170.  
  171.  
  172. Current list of file types Honto can Identify
  173. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  174. Extra       Versions that
  175. info  ext   Honto knows
  176. ----  ---   -------------
  177.       ARC : All versions
  178.   X   ARJ : All versions
  179.       LZH : All known versions
  180.       UC2 : R1, R2
  181.   X   ZIP : All versions
  182.  
  183.       OBJ : Microsoft/Intel format
  184.       OVR : All versions I could find
  185.   X   TPU : Turbo Pascal v4.0-7.0 (all)
  186.  
  187.       C   : N/A
  188.       PAS : Programs & units
  189.       TXT : N/A
  190.       WPD : Word Perfect 5.x only
  191.       WRD : Word v5.5
  192.  
  193.       ANS : N/A
  194.   X   BMP : All versions
  195.   X   GIF : All versions
  196.   X   JPG : JFIF and others
  197.       LBM : N/A
  198.   X   PCX : All versions
  199.   X   TD  : All versions
  200.       WAD : All versions
  201.  
  202.   X   VOC : 1.10,1.20
  203.   X   WAV : N/A
  204.  
  205.       BAT : N/A
  206.       COM : Most .COM files I could find
  207.   X   EXE : DOS,OS/2,Windows
  208.       SYS : Most .SYS files I could find
  209.  
  210.